package com.guan.common.core.utils;

import cn.hutool.core.util.StrUtil;
import com.alibaba.ttl.TransmittableThreadLocal;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

/**
 * {@code ThreadLocalUtil} 是一个工具类，用于管理线程本地存储的数据。
 * 该类使用 {@link TransmittableThreadLocal} 进行线程局部存储，允许在异步操作中传递数据。
 * 它可以为每个线程维护一个 {@link Map}，并通过键值对存储对象。
 * 支持线程内存储的值在子线程中传递，适用于跨线程的任务数据传递。
 * <p>
 * 类中的所有操作都是线程安全的，采用了 {@link ConcurrentHashMap} 作为内部存储。
 * </p>
 */
public class ThreadLocalUtil {

    // 使用 TransmittableThreadLocal 来保证跨线程传递数据
    private static final TransmittableThreadLocal<Map<String, Object>> THREAD_LOCAL = new TransmittableThreadLocal<>();

    /**
     * 设置指定键的值到线程本地存储中，如果值为 {@code null}，则设置为 {@link StrUtil#EMPTY}。
     *
     * @param key   存储的键
     * @param value 存储的值，可以为 {@code null}
     */
    public static void set(String key, Object value) {
        Map<String, Object> map = getLocalMap();
        map.put(key, value == null ? StrUtil.EMPTY : value);
    }

    /**
     * 获取指定键对应的值。如果该键不存在，则返回 {@code null}。
     *
     * @param key   要获取值的键
     * @param clazz 值的类型，用于类型转换
     * @param <T>   值的类型
     * @return 返回值，类型为 {@code T}，如果键不存在则返回 {@code null}
     */
    public static <T> T get(String key, Class<T> clazz) {
        Map<String, Object> map = getLocalMap();
        return (T) map.getOrDefault(key, null);
    }

    /**
     * 获取当前线程的本地存储的 {@link Map} 实例。如果线程本地存储尚未初始化，则创建并返回一个新的 {@link ConcurrentHashMap}。
     *
     * @return 当前线程的本地 {@link Map} 实例
     */
    public static Map<String, Object> getLocalMap() {
        Map<String, Object> map = THREAD_LOCAL.get();
        if (map == null) {
            map = new ConcurrentHashMap<>();
            THREAD_LOCAL.set(map);
        }
        return map;
    }

    /**
     * 移除当前线程的本地存储。清理线程本地存储中的数据。
     */
    public static void remove() {
        THREAD_LOCAL.remove();
    }
}
